home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 2: CDPD 1 / Almathera Ten on Ten - Disc 2: CDPD 1.iso / pd / 301-325 / 315 / drawmap / drawmap.doc < prev    next >
Text File  |  1995-03-14  |  5KB  |  109 lines
  1.                                  Drawmap
  2.                                  
  3.                                Version 2.0
  4.  
  5.        A program for drawing representations of the Earth's surface.
  6.  
  7.                                     by
  8.  
  9.                                 Bryan Brown
  10.  
  11.                                  01/30/90
  12.  
  13.  
  14. I. Distribution
  15.  
  16.      As with version 1.0 (on Fish disk 229), this program is released into
  17. the public domain (FREEWARE), and is freely distributable as long as this
  18. document file, source code, header files and map files are included in their
  19. entirety.  The source may be modified for personal use, but is NOT for
  20. commercial use.  The program was developed with Aztec C v. 3.6a.  Users of
  21. Lattice C should have little difficulty recreating the executable from
  22. source, however.
  23.  
  24. Files included:
  25.  
  26.     drawmap.doc                 - this documentation file
  27.     drawmap.c                   - source code
  28.     drawmap.h                   - header file
  29.     drawmap-menu.h              - header file for menu selections
  30.     drawmap-req.h               - header file for string requester
  31.     drawmap                     - executable code
  32.     map.bin                     - map file (same as in version 1.0)
  33.     map-trig.bin                - map file (same as in version 1.0)
  34.     map-tidy.bin                - special map file (see below)
  35.     map-tidy-trig.bin           - special map file (see below)
  36.     makedrawmap                 - simple batch file for building the
  37.                                   executable code
  38.     pop.doc                     - documentation for the pop-up menu
  39.                                   code
  40.     pop.c                       - original source code for the pop-up
  41.                                   menus
  42.     pop-drawmap.c               - source for pop-up menus, modified for
  43.                                   this application
  44.     popmenu.h                   - header file needed by pop.c and
  45.                                   pop-drawmap.c
  46.     makepop-drawmap             - batch file for compiling pop-drawmap.c
  47.     
  48.  
  49. II. Enhancements to Version 1.0
  50.  
  51.     (1) New functions:
  52.     
  53.         (a) Shadow - This makes a dropshadow of land masses onto the water
  54.             areas.  The implementation is loosely based on Scott Steinman's
  55.             FastPix algorithm from Amazing Computing, vol. 4, no. 11.
  56.  
  57.         (b) Text - The user may now enter text to be written on the maps,
  58.             text positioning being via the mouse.  User text input is via a
  59.             simple string requester, and is limited to a maximum of 30
  60.             characters.  No provision is made for alternate fonts.
  61.  
  62.     (2) Modifications:
  63.  
  64.         (a) A better-looking mouse pointer is provided, similar to that
  65.             on IRIS workstations.
  66.  
  67.         (b) Instructions to the user to wait are now via a modified
  68.             mouse pointer instead of via a message in the window title bar.
  69.  
  70.         (c) Event handling has been improved.  In version 1.0, pressing
  71.             the menu button before a drawing had completed caused the pop-up
  72.             menu to appear as soon as the drawing was complete.  In this
  73.             version, all inappropriate events are disabled until drawing is
  74.             complete.
  75.  
  76.         (d) A brute force method of color-filling partially drawn regions
  77.             is used.  Special arrays of points (files map-tidy.bin and map-
  78.             tidy-trig.bin) is scanned, each point having been carefully
  79.             chosen to lie within a land mass.  If a point in the array is
  80.             visible (based on the type of map being displayed), that point is
  81.             used in the flood-fill function to color-fill the region in which
  82.             it lies.  While not elegant, the method at least has the virtue
  83.             of working for large regions.  It is still possible to miss small
  84.             regions, however.
  85.  
  86. III. Miscellaneous
  87.  
  88.     (1) Speed - No attempt has been made to speed up the drawing process.
  89.         Single precision floating point calculations (FFP package) have
  90.         sufficient accuracy for these display purposes, since the accuracy is
  91.         limited by the accuracy of the map files.  In fact, using the IEEE
  92.         floating point option of the Aztec C compiler without a 68881 math
  93.         coprocessor results in a marked speed penalty.  As might be expected,
  94.         however, a 68881 does improve performance over that of the FFP
  95.         package.  Some tests with a 33 MHz 68030 board show impressive
  96.         results, such as completing a globe view in 3 to 4 seconds.  No tests
  97.         have been made with a 68030 and 68882 combination, however.
  98.  
  99. IV. Correspondence
  100.  
  101.      In addition to my work address (given with version 1.0), I may now be
  102. reached at my new home address also:
  103.  
  104.             Bryan Brown
  105.             13129 Collingwood Terrace
  106.             Silver Spring, MD  20904
  107.  
  108. Any questions, suggestions, etc., are always welcome.
  109.